home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / Spiele / magicgam / BOUT2 / README.TXT < prev   
Encoding:
Text File  |  1999-12-04  |  9.1 KB  |  247 lines
  1.  
  2.  
  3.      Documentation for BoinkOut2
  4.      Current Revision: D
  5.  
  6. What is it?
  7.  
  8.      A "BreakOut" style game.  Bounce the ball off of the paddle
  9.      to destroy the bricks.  Destroy all the non permanent bricks
  10.      and the level is finished.
  11.  
  12.      What Resolutions does it support?
  13.  
  14.      Right now realistically.  ST High and Above.  There is code in
  15.      the program to work with ST Medium.  But it is not working at the
  16.      moment.  It will attempt to run in whatever resolution you
  17.      boot it in as if the screen were big enough for it to run.
  18.      This in one way is annoying, but in another avoids some of the
  19.      resolution detection problems that I had in the past when
  20.      working on AstroPanic.
  21.  
  22.      ie.  If the screen resolution isn't high enough.  It's damn
  23.      hard to play ;)
  24.  
  25.      What Color Depth does it support?
  26.  
  27.      Any.  With the default images, it's happiest in 8 bit color (256
  28.      colors) or higher.  However you can load your own background
  29.      image with whatever depth you like (1-8 planes).
  30.  
  31.      What Img formats does it support?
  32.  
  33.      Ximg and normal Atari Image formats should work for your backgound
  34.      images.  BoinkOut2 does not support Truecolor Ximg files.
  35.  
  36.      What is "timing"?
  37.  
  38.      The entire program operates off of the VDI and AES.  The
  39.      timing value is what you want the default minimum timing 
  40.      to be.  For an ST this should be 0.  However for a TT
  41.      with a graphics card.  I recommend in the range of 30.
  42.      You will want to set the timing to whatever you feel is
  43.      the most enjoyable for your system.
  44.  
  45.      Any cool things not listed in the Menu?
  46.  
  47.      Yes one.  Close the gameplay window.  Hold down the Right Shift key
  48.      and select Open Window from the Menu.  This should launch you into
  49.      the demo mode.  You will then be able to watch the game run through
  50.      the levels.
  51.  
  52. Controls
  53.  
  54.      The game is controled with the mouse.  Moving the mouse will
  55.      move the paddle in the play area.  Extra features of the game
  56.      can be accessed from the Menu Items or Hotkeys.
  57.  
  58.      HOTKEYS
  59.  
  60.      Certain keys or combinations of keys operate as shortcuts.
  61.  
  62.      Control - O   Open a New Game window (only if not already open)
  63.  
  64.      Control - N   Start a New game.  Opens new window if necessary.
  65.  
  66.      Esc           Pause a game in progress. Pressing again unpauses.
  67.  
  68.      Control - Q   Quit the program
  69.  
  70.      Control - L   Load a background image. User selectable via
  71.                     the file selector.
  72.  
  73.      
  74.      Menu Items
  75.  
  76.      About BoinkOut2
  77.  
  78.           Displays information about the game.  Revision and URL.
  79.  
  80.      Open Window
  81.           
  82.           Opens a Game window if there is not already one open.
  83.  
  84.      New Game
  85.  
  86.           Starts a New Game.  Will abort a game in progress.  Will
  87.           open a new window if necessary.
  88.  
  89.      Pause Game
  90.  
  91.           Pauses a game in progress.  Selecting again will unpause
  92.           the game.
  93.  
  94.      Quit
  95.  
  96.           Exits the program.
  97.  
  98.      Set Timing
  99.  
  100.           Opens the Timing Dialog.  For "What is timing" see above.
  101.           
  102.           Suggested timing values to start with:
  103.  
  104.           Normal ST      0   (Includes All 8 mhz 68000 Atari's)
  105.           TT/Nova Gfx    30
  106.           060 clones     60  (Seems to be a good place to start)
  107.  
  108.           You will want to experiment with the timing for your own
  109.           system.  Let me reitterate.  Experiment with the speeds
  110.           what is a good speed for one person will be a quick trip
  111.           to game end for another.  This is for entertainment, set
  112.           the timing to where you have fun.
  113.           
  114.      Load New Background...
  115.  
  116.           Opens system file selector.  This allows you to select a
  117.           new (X)IMG file to operate as the backdrop to the game
  118.           play area.  See "What image formats " above.
  119.  
  120.      Sound ON/OFF
  121.      
  122.          This toggles whether to play any sounds or not.  When off
  123.          your boss or wife won't know what you are doing ;)
  124.  
  125.      Load Level Set...
  126.  
  127.           Opens system file selector.  This allows you to select a
  128.           new LVL file.  LVL files are level description files for
  129.           BoinkOut2.  You can make your own LVL files and share
  130.           them with your friends.
  131.  
  132.      View High Scores
  133.  
  134.           Opens the High Score window.  This will show you how well
  135.           you or your friends have done in the past.  It will also
  136.           show you the first time you play, that I have watched too
  137.           many episodes of "Are You Being Served?", over the years.
  138.  
  139.      Save Preferences
  140.  
  141.           This option will save your game preferences.  At the moment
  142.           this only saves your Timing variable.
  143.  
  144.  
  145. Game Play
  146.  
  147.      BoinkOut2 at it's heart is a breakout game.  If you don't know
  148.      what breakout is then play it for a few minutes and you will know ;)
  149.  
  150.      However BoinkOut2 is also close to the family of Arkanoid.  Kind
  151.      of a Breakout+.
  152.  
  153.      The game takes place in the game window.  We will refer to this
  154.      as the play area.  At the top of the play area, you will see
  155.      three fields.
  156.  
  157.      The first is preceded by a strange shaped litle object that is
  158.      a representation of the ball used in play.  The number next to
  159.      it shows how many balls you have left.  Note.  If it says 1
  160.      you are on your last ball.  Once you hit 0 the game is over.
  161.  
  162.      The next field is the Level indicator.  This shows what level
  163.      you are on.  The built in levels of BoinkOut2 number 36, once
  164.      (if) you hit 36 you will wrap and start at level 1 again.
  165.  
  166.      The last field on the right is your score.
  167.  
  168.      Below this should be an array of blocks.  Level 1 has 7 rows
  169.      and 9 columns of blocks.  Level 1 has all normal blocks.
  170.  
  171.      There are several types of blocks in the game.
  172.  
  173.      1. Normal bricks.        One hit and they are gone.
  174.      2. Normal Spin bricks.   Look a bit different one hit.
  175.      3. Double Spin bricks.   Two hits to get rid of this.
  176.      4. Triple Spin bricks    Three hits...
  177.      5. Quadruple Spin bricks Four hits...
  178.      6. Permanent bricks      Can not be destroyed.
  179.      7. Magic Bricks          See below
  180.  
  181.      Magic Bricks are the fun ones.  You never know quite what is
  182.      going to happen.  The play area could be erased, all the bricks
  183.      can become invisible, multiple balls can come out.  There are
  184.      some suprises waiting for you with these.
  185.  
  186.      At the bottom of the play area, is an open area containing your
  187.      paddle.  This is what you use to hit the balls back up.  A ball
  188.      hitting the bottom of the play area dies.
  189.  
  190. Making your own Level Sets.
  191.  
  192.      To make your own level sets open up your favourite text processor
  193.      and edit away!  Actually is fairly easy to do.  The built in
  194.      levels exist in a file called BOINKOUT.LVL, this will show you
  195.      how all the levels that you have played are put together.
  196.      I've also included another file called TEST.LVL, this is not
  197.      a recommended set.  But shows that you can load more than one
  198.      level set.
  199.  
  200.      All the rules for building your own levels exist in either of the
  201.      .LVL files.  They are fairly easy.  Levels have 63 blocks, 9 columns
  202.      by 7 rows.  The identifiers for the block types are in the files.
  203.      One big warning.  NO SPACES in the data area.  This will cause the 
  204.      file to be misinterpreted.
  205.      
  206.      NOTE:  There is a hard coded maximum of 99 levels that can be loaded
  207.      from a LVL file.
  208.  
  209. Hey sometimes my balls bounce off the bottom of the play area instead
  210. of dieing.
  211.  
  212.      You are the lucky recipient of the Magic Bottom!  Magic bottom
  213.      can be invoked by a magic block.  However sometimes the clipping does 
  214.      miss a ball and sends it bouncing back up.  Smile don't complain.
  215.  
  216. Anything Else? 
  217.  
  218.      Yes I'm sure there should be.  If anyone has any questions or input
  219.      on what should be in the docs let me know.  I still have a few more
  220.      things that I'm planning on adding.  I know it's getting kind of late.
  221.      But I've already worked most of them out.  They just aren't implemented
  222.      in this binary.
  223.  
  224.  
  225. Finals notes:
  226.  
  227.     This probably isn't the pretiest program in the competition.  As usual
  228. for me, I didn't get the time to really get the bits and bobs done that I 
  229. wanted to get done.  However I hope that the game is playable.  The souce
  230. will be available on my web page, if you feel so motivated to go in and 
  231. clean up the bits I didn't get finished.  Please let me know if you do.
  232.  
  233.     I also owe alot of thanks to a lot of people for getting it to this state.
  234. All the people on my beta list (Charles Silver, Edward Baiz, David Leaver and
  235. Paul Williams to name a few (my memory is lapsing and I don't have enough time
  236. to log in and get the rest.  Please accept my apologies if I left you out) and
  237. SWE who did alot of real time testing for me via #atariscne on IRC.
  238.  
  239.     I also owe alot of thanks (as we all do) to many other programmers over
  240. the years who have helped me out when I've gotten into hard spots.  I'd list
  241. you all, but then everyone would realize that I don't program anything I just
  242. recompile ;)
  243.  
  244.     Have fun and enjoy,
  245.  
  246.      Dan Ackerman
  247.      baldrick@netset.com